home *** CD-ROM | disk | FTP | other *** search
/ Amiga Tools 2 / Amiga Tools 2.iso / grafik / triton / readme < prev    next >
Text File  |  1994-04-09  |  7KB  |  206 lines
  1.  
  2.                 **********************************************
  3.  
  4.                     triton.library
  5.  
  6.                     The object oriented GUI creation system.
  7.  
  8.                     Release 1.0
  9.  
  10.                     (c) 1993-1994 Stefan Zeiger
  11.  
  12.                 **********************************************
  13.  
  14.  
  15.     Be sure to read the file 'Distribution', too!
  16.  
  17.     If you have suggestions or remarks about Triton, or if you find
  18. any bugs, please let me know.
  19.  
  20.     Contacting the author:
  21.  
  22.         EMail:      stefan@wwsp.adsp.sub.org
  23.  
  24.         Z-Netz:     stefan@sweet.zer
  25.                     stefan@plus.zer
  26.  
  27.         FidoNet:    Stefan Zeiger 2:244/6302.15
  28.  
  29.         Mail:       Stefan Zeiger
  30.                     Seligenstädter Weg 24
  31.                     D-63796 Kahl
  32.                     Germany
  33.  
  34.         Voice:      +49-6188-2525 (after 6:00 PM GMT only!)
  35.  
  36.     Please use EMail/Z-Netz/FidoNet if possible. This is more convenient for
  37. me and your chance of getting a reply quickly is much better.
  38.  
  39.  
  40. Contents
  41. ========
  42.  
  43. 1. Introduction
  44.  
  45. 2. Installation
  46.  
  47. 3. Using triton.library
  48.  
  49. 4. Astronomy Lesson
  50.  
  51. 5. Library history
  52.  
  53. 6. Credits
  54.  
  55.  
  56. 1. Introduction
  57. ===============
  58.  
  59.     triton.library is a standard Amiga shared, runtime library.  Triton
  60. makes it much easier to create good-looking graphical user interfaces (GUIs)
  61. than GadTools, BOOPSI or other systems.
  62.  
  63.     The most important features are:
  64.  
  65.     - Object oriented system
  66.     - Automatically font sensitive, font adaptive
  67.     - Automatic keyboard shortcuts for default window actions
  68.     - *Really* easy to use
  69.     - Beautiful OS2.x/3.x look
  70.     - Comes as a freely distributable shared library
  71.     - Size! Though Triton is very powerful, it is a shared library of less
  72.       than 40KB. You don't need any startup tools, editors, BOOPSI classes
  73.       or other things. It's the Triton among the minnows of GUI creation
  74.       systems ;)
  75.     - Resizeability of windows wherever applicable
  76.     - No large stack required
  77.  
  78.     By using Triton you don't have to worry about otherwise very
  79. time-consuming things like font-sensitivity and resizeability of your
  80. windows. What is even more important is that you can easily change your user
  81. interfaces later without having to rearrange display objects. Simply add an
  82. object to a group and the whole GUI will adapt to make room for it.
  83.  
  84.     The usage of a Triton GUI should be pretty clear.  All windows have
  85. two additional keyboard shortcuts (if not explicitly disabled by the
  86. application):  'Esc' will simulate the 'close window' gadget and 'Del' will
  87. simulate the 'resize window' gadget.  In palette, slider, scroller and
  88. similar gadgets with an up/down facility you can use the shifted shortcut to
  89. decrease the value.
  90.  
  91.  
  92. 2. Installation
  93. ===============
  94.  
  95.     First of all, Triton requires OS2.04 or higher. If you're still running
  96. 1.2 or 1.3, you have to upgrade to OS2.04 or better.
  97.  
  98.     To install triton.library copy it to your Libs: directory by hand, or
  99. run the installation script which corresponds to your system (OS2.0, OS2.1+
  100. with different languages) by double-clicking its icon.
  101.  
  102.  
  103. 3. Using triton.library
  104. =========================
  105.  
  106.     If you are a C programmer all you need to do is include the correct
  107. header ('libraries/triton.h') and open triton.library. After that you can
  108. use the functions in the library as if they were C functions. If your program
  109. quits it must of course close the library again. You may also use the support
  110. functions in the Triton linker library which make it even easier to use
  111. Triton. See 'demo.c' for an example.
  112.  
  113.     The FD (function description) file is included for the case that you
  114. want to write glue code for other compilers/languages. If you do so, please
  115. send it to me for inclusion in the next Triton distribution.
  116.  
  117.     Functions allowing a variable number of arguments can't be called using
  118. pragmas (in-line library calls; no glue code required). So if you use these
  119. you must always link with LIB:triton.lib (for SAS/C, or with the specific
  120. libraries for your compiler/language). All library functions are explained
  121. in the autodoc file 'triton.doc'.
  122.  
  123.                                                 Live long and prosper!
  124.  
  125.  
  126. 4. Astronomy Lesson
  127. ===================
  128.  
  129.                         Triton - A moon of Neptune
  130.  
  131.     Triton is a quaint little moon, in that it is one of the very few moons
  132. to be known to have retrograd orbits around their host. Triton is believed to
  133. be a 3-6000 km large world of mostly liquid nitrogen oceans, perhaps with a
  134. thin methane atmosphere as well, but noone knows for sure since either of the
  135. Voyager twins ever got close enough to take convincing snapshots.
  136.  
  137.     Neptune itself is also quite strange in that it has an almost 90 degree
  138. tilted inclination, so that it "rolls" through space, unlike Earth and the
  139. other planets (minus Venus), which all spin like tops in their orbits. Noone
  140. can tell for sure why Neptune has such an excentric inclination, but it has
  141. been suggested that it was caused by a gigantic collision of some sort
  142. (probably with a large asteroid). In the process Neptune also lost its third
  143. moon, which at the time was none other than Pluto. The collision accellerated
  144. Pluto to the point where it had enough momentum to actually leave its orbit
  145. and shoot into space on its own. As it did so it probably passed below the
  146. Roche' radius of Neptune, causing it to break up in two or more bodies under
  147. the influence of the massive tidal forces of Neptune. This would certainly
  148. account for Charon, which is in itself too large to have been "captured" by
  149. an object as small as Pluto.
  150.  
  151. Okay, end of today's astronomy lesson :-)
  152.  
  153.  
  154. 5. Library History
  155. ==================
  156.  
  157. *****************************************************************************
  158. RELEASE 1.0 (Library version 1.138)
  159.  
  160.     First release.
  161.  
  162.     Missing features, known bugs:
  163.     - No mutually exclusive menus
  164.     - TRAT_ID must be the *last* tag for all menu items
  165.     - No class authoring interface. This will follow soon. I will optimize
  166.       the class interface first.
  167.     - triton.library is a multiple-base library! That means you may not
  168.       use it from within single-base libraries and you cannot call
  169.       SetFunction() on functions of triton.library.
  170.     - triton.lib doesn't contain glue code for the library functions. You
  171.       have to create it yourself. I will add glue code in the next release.
  172.  
  173. *****************************************************************************
  174.  
  175.  
  176. 6. Credits
  177. ==========
  178.  
  179. Thanks must go to:
  180.  
  181.     - Nico François for his suggestions, beta-testing and helping me with
  182.       some very weird problems in Triton
  183.  
  184.     - Carsten Raufuß for beta-testing, suggestions and nagging ('When will
  185.       you finally implement listviews? I really need them for my GUI!' :-)
  186.  
  187.     - Kai Iske for his BOOPSI class sources
  188.  
  189.     - Michael Berg for the 'Astronomy Lesson' and beta-testing
  190.  
  191.     - All the unmentioned guys on SPOT.BETA for beta-testing and suggestions
  192.  
  193.     - Marco Frischkorn for beta-testing
  194.  
  195.     - Danny Schrod and Chris Reichert (SysOps of 'Plus' and 'Publishers
  196.       Treff') for support
  197.  
  198.     - SAS Institute for their great SAS/C compiler. With SAS/C it was
  199.       possible to develop Triton without a single line of assembly
  200.  
  201.     - Commodore for the Amiga
  202.  
  203.                   __
  204.                __///
  205.                \\\/...if(2B|!2B) user->prefs.shakespeare=TRUE;
  206.